home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / dglopen.z / dglopen
Encoding:
Text File  |  2002-10-03  |  6.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddggggllllooooppppeeeennnn((((3333GGGG))))                                                        ddddggggllllooooppppeeeennnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddggggllllooooppppeeeennnn - opens a Graphics Library connection to a graphics server
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      lllloooonnnngggg ddddggggllllooooppppeeeennnn((((ssssvvvvnnnnaaaammmmeeee,,,, ttttyyyyppppeeee))))
  13.      SSSSttttrrrriiiinnnngggg ssssvvvvnnnnaaaammmmeeee;;;;
  14.      lllloooonnnngggg ttttyyyyppppeeee;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _s_v_n_a_m_e   expects a pointer to the name of the graphics server to which
  18.               you want to open a connection.
  19.  
  20.               For a successful connection, the client host must have
  21.               permission to connect to the graphics server.  Authentication is
  22.               accomplished via the same mechanisms as for X clients.  See
  23.               xhost(1) for further details.
  24.  
  25.               The _s_v_n_a_m_e parameter has the following syntax:
  26.  
  27.               [[_u_s_e_r_n_a_m_e ]_p_a_s_s_w_o_r_d@]_h_o_s_t_n_a_m_e[:_s_e_r_v_e_r[._s_c_r_e_e_n]]
  28.  
  29.               where _h_o_s_t_n_a_m_e is an internet host name recognized by
  30.               gethostname(3N).  _s_e_r_v_e_r and _s_c_r_e_e_n are ignored, and both are
  31.               set to 0.
  32.  
  33.               For DECnet connections, if the server account has a password,
  34.               this password must be specified by including _u_s_e_r_n_a_m_e and
  35.               _p_a_s_s_w_o_r_d.  This password is used only for opening the DECnet
  36.               connection; the local and remote accounts must still be
  37.               equivalent in the _r_l_o_g_i_n sense.
  38.  
  39.      _t_y_p_e     expects a symbolic constant that specifies the kind of
  40.               connection.  There are three defined constants for this
  41.               parameter:
  42.  
  43.               DDDDGGGGLLLLLLLLOOOOCCCCAAAALLLL indicates a direct connection to the local graphics
  44.               hardware.  This type of connection is not supported on client
  45.               machines without IRIS graphics hardware.
  46.  
  47.               DDDDGGGGLLLLTTTTSSSSOOOOCCCCKKKKEEEETTTT indicates a remote connection via TCP/IP.
  48.  
  49.               DDDDGGGGLLLL4444DDDDDDDDNNNN indicates a remote connection via DECnet.
  50.  
  51. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  52.      If the connection succeeds, the returned value of the function is a non-
  53.      negative integer, _s_e_r_v_e_r_i_d, that identifies the graphics server.  If the
  54.      connection failed, the returned value for the function is a negative
  55.      integer.  The absolute value of a negative returned value is either a
  56.      standard error value (defined in <_e_r_r_n_o._h>) or one of several error
  57.      returns associated specifically with ddddggggllllooooppppeeeennnn:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddggggllllooooppppeeeennnn((((3333GGGG))))                                                        ddddggggllllooooppppeeeennnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      EEEENNNNOOOODDDDEEEEVVVV      _t_y_p_e is not a valid connection type.
  75.  
  76.      EEEEAAAACCCCCCCCEEEESSSS      login incorrect or permission denied.
  77.  
  78.      EEEEMMMMFFFFIIIILLLLEEEE      too many graphics connections are currently open.
  79.  
  80.      EEEENNNNOOOOPPPPRRRROOOOTTTTOOOOOOOOPPPPTTTT DGL service not found in ////eeeettttcccc////sssseeeerrrrvvvviiiicccceeeessss.
  81.  
  82.      EEEERRRRAAAANNNNGGGGEEEE      invalid or unrecognizable number representation.
  83.  
  84.      EEEEPPPPRRRROOOOTTTTOOOONNNNOOOOSSSSUUUUPPPPPPPPOOOORRRRTTTT
  85.                  DGL version mismatch.
  86.  
  87.      EEEESSSSRRRRCCCCHHHH       the window manager is not running on the server.
  88.  
  89. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  90.      ddddggggllllooooppppeeeennnn opens a Graphics Library connection to a graphics server
  91.      (_s_v_n_a_m_e).  After a connection is open, all graphics preferences, input,
  92.      and output are directed to that connection.  This direction is continued
  93.      until either the connection is closed, another connection is opened, or a
  94.      different connection is selected.  A different connection can be selected
  95.      by calling a subroutine that takes a graphics window identifier as an
  96.      input parameter, e.g. wwwwiiiinnnnsssseeeetttt.  The server connection associated with that
  97.      graphics window identifier becomes the current connection.  To close a
  98.      connection, call ddddggggllllcccclllloooosssseeee with the server identifier returned by ddddggggllllooooppppeeeennnn.
  99.  
  100.      If a remote server error occurs, the graphics application may exit with a
  101.      status value EIO and produce the following error message:
  102.  
  103.           dgl error (comm): read returned 0
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      dglclose, finish, gflush, winopen, winset, scrnselect
  107.  
  108.      rlogin(1C), gethostbyname(3N) in the _I_R_I_S-_4_D _U_s_e_r'_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l
  109.  
  110. NNNNOOOOTTTTEEEESSSS
  111.      This routine is available only in immediate mode.
  112.  
  113.      This routine is available in both the GL and DGL libraries.  However, the
  114.      DDDDGGGGLLLLLLLLOOOOCCCCAAAALLLL connection type is not supported by the DGL library.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.